home *** CD-ROM | disk | FTP | other *** search
/ Amiga Magazin: Amiga-CD 1996 September & October / Amiga-CD 1996 #9-10.iso / demos / storm-c / stormc / readme < prev    next >
Text File  |  1996-07-02  |  10KB  |  362 lines
  1. Welcome to the demo of StormC 1.1
  2.  
  3. [1m © HAAGE & PARTNER Computer GmbH [0m
  4.  
  5.   Mainzer Straße 10A
  6.   61191 Rosbach v.d.H.
  7.  
  8.   Tel: 0 60 07 / 93 00 50
  9.   Fax: 0 60 07 / 75 43
  10.  
  11.   Compuserve: 100654,3133
  12.   Internet: 100654.3133@compuserve.com
  13.   Homepage: http://ourworld.compuserve.com/homepages/haage_partner
  14.  
  15. In November 1995 at the COMPUTER 95 we released the first German Preview 
  16. of StormC. The visitors of the exhibition were amazed at the new 
  17. concepts and innovations of StormC.
  18.  
  19. Some impressions of articles of the German press regarding the Preview 
  20. version: (I will try to translate it as close to the original as 
  21. possible)
  22.  
  23. Amiga Plus 1 / 96
  24.  
  25.   New concepts of development and quality assurance... 
  26.   The first remarkable feature is the project management...
  27.  
  28. Amiga magazine 1 / 96
  29.  
  30.   The project management: At last there is a tool that does not feel like a 
  31.   "ball and chain", but is really useful.
  32.  
  33. Amiga Special 2 / 96
  34.  
  35.   A fast compiler, a powerful debugger and a comfortable
  36.   development system are an interesting mixture, if we talk about
  37.   professional software engineering..
  38.  
  39.  
  40. With the enclosed demo you can convince yourself of these statements.
  41.  
  42.  
  43.  
  44. Restraints of the demo:
  45. ================================
  46.  
  47. The enclosed compiler will compile your large sources but he will however 
  48. write a maximum of 10 KB of object code. But you can get the assurance 
  49. that your large projects can be compiled too.
  50.  
  51. The linker can write programs with a maximum of 20 KB of 
  52. size.
  53.  
  54. All parts of StormC can NOT be started from CLI. They can be used only 
  55. with the integrated environment.
  56.  
  57.  
  58. Important:
  59. ===========================
  60.  
  61. This demo is optimised for installation from CD-ROM. If you have copied 
  62. the files to your hard disk already you need not to do the installation. 
  63. You should then enter solely an assign to StormC into the "user-startup",
  64. so the demo programs and the pre-sets of StormC can be used unchanged.
  65.  
  66. Include - Licences:
  67. =================
  68.  
  69. If you have got the demo from a mailbox or from the Aminet, only our 
  70. includes and libraries are included. For programming you will soon 
  71. need the complete system includes of Kickstart/Workbench 3.1.
  72.  
  73. How to get these includes?
  74. -------------------------------
  75.  
  76. 1.
  77. We can send you a demo of StormC with all includes, but you have to 
  78. pay a charge of 20 $ (30 DM). This amount is deducted when you purchase StormC. 
  79. You have to pay in advance.
  80.  
  81. 2.
  82. You will find the complete includes and libraries on the CD 1/96 of 
  83. the German "Amiga Magazin".
  84.  
  85. 3.
  86. If you have got our Preview of StormC you have already got these 
  87. files too.
  88.  
  89. You only have to add the following files:
  90.  
  91. In the includes drawer the directories:
  92.  
  93.   datatypes
  94.   devices
  95.   diskfont
  96.   dos
  97.   exec
  98.   gadgets
  99.   graphics
  100.   hardware
  101.   intuition
  102.   libraries
  103.   prefs
  104.   resources
  105.   rexx
  106.   utility
  107.   workbench
  108.  
  109. In the libs drawer the libraries:
  110.  
  111.   amiga.lib
  112.   small.lib
  113.   debug.lib
  114.   ddebug.lib
  115.  
  116. Please do not use the includes of other compilers or directly these of other
  117. compilers or our Preview. We have altered some of them, so they will only 
  118. work the way we told you.
  119.  
  120.  
  121. Modifications and expansions to the Preview:
  122.  
  123. In General
  124. ----------
  125.  
  126. The complete environment is localised now. The pre-set language is English.
  127.  
  128. Should you use an English Workbench but want to use the German StormC 
  129. you have to rename the locale file 
  130. "StormC:StormSYS/CATALOGE/German/StormCPP.catalog".
  131.  
  132. Starting the program
  133. --------------
  134.  
  135. Contrary to the description in the manual on page 12 the start-up picture 
  136. does not appear if your Workbench screen has less than 64 colours. In 
  137. this case a small window appears and tells you that the system is 
  138. still loading.
  139.  
  140. Project management (StormShell):
  141. -------------------------------
  142.  
  143. You can use multiple selection on "add file(s)".
  144.  
  145. You can drop Workbench icons (Appwindow) into the project windows.
  146.  
  147. The new menu item "add library(s)..." is the same as "add file(s)...". 
  148. The default path of the ASL file requester is set to "#?.lib". 
  149. The only problem is: multiple selections are always alphabetically 
  150. sorted by the ASL requester. The relevant sequence of libraries can 
  151. only be kept if you add one library after the other to your project.
  152.  
  153. If you add a new file an icon will be created too (optional). The icon 
  154. is taken from "ENV:STORMCPP/def_text.suffix". ".suffix" represents the 
  155. suffix of the file name (e.g. c or h). So you can have different icons 
  156. for different kinds of sources.
  157.  
  158. The pre-sets can be saved and loaded by the StormShell.
  159.  
  160. Two new option pages were added to the project defaults. Another for 
  161. the optimiser of the compiler.
  162.  
  163. Nearly every parameter of the shell environment can be
  164. set at the start of a program.
  165.  
  166. The setting for 32 bit correct multiplication has been deleted. The 
  167. compiler now decides automatically which multiplication is required.
  168.  
  169. You can now select small or large code model.
  170.  
  171. Hint: We do not deliver libraries that support small code model with 
  172. the demo. If you select this option your program will not work.
  173.  
  174. "Make" and "Compile" automatically save your sources now.
  175.  
  176. The functions of the icon bar are available by function keys F1 to 
  177. F10 now.
  178.  
  179. The About window and the option windows can be closed with ESC too.
  180.  
  181. The error window is now accessible by keys:
  182. Use "w" toggles warnings on/off.
  183. Use the cursor keys go through the error list.
  184. Use <Alt> + cursor keys to go to the first or last error message.
  185. Use <Return> to indicate the error message in the editor.
  186.  
  187. The project window is completely accessible by keys too.
  188. Use the cursor keys to move the cursor and the contents.
  189. <Alt><up>/<down> jumps to start/end of the entries
  190. <Shift><right>/<left> jumps to the margins
  191. <Return> executes the action
  192. <Alt><Return> the respective alternative
  193. Backspace and/or Delete deletes the entry under the cursor from the 
  194. project.
  195.  
  196. Debugger (StormRUN):
  197. --------------------
  198.  
  199. The debugger demo described in the manual unfortunately only works with 
  200. operating system V39 and higher. If you have V37/38 you should try the 
  201. Gadtools demo.
  202.  
  203. The menu item "save program as..." is not available in the current demo, 
  204. because we are changing some things.
  205.  
  206. The values of simple number types (char - long) can be changed in all 
  207. variable and inspect windows.
  208.  
  209. We added a hex editor.
  210. With the Tab key you can jump between the columns.
  211. Use "Save Settings" to store the layout of the hex editor.
  212.  
  213. The type output has two modes: 
  214. ANSI-C or AMIGA-C (with ULONG, BYTE ...).
  215. The compiler can not save this in its debug information so we use the 
  216. Amiga-C notation (more compact).
  217.  
  218. Resource-Tracking is now implemented.
  219. If you end a program or "Kill" it screens, windows, memory, libraries, 
  220. locks and files that were not closed or released will be shown. A double 
  221. click onto the entry of the list brings you to the according function call. 
  222. The new menu "Debug" got the menu item "Flush Resources"  to release 
  223. these resources.
  224.  
  225. The resource tracking can determine the direct "caller" only. I.e. the 
  226. function which contains jsr d(a6). A stub function for library calls 
  227. prevents the correct  indication of the call. 
  228. So you should avoid stub functions and use "pragma amicall" and 
  229. "tagcall".
  230.  
  231.  
  232. Editor:
  233. =======
  234.  
  235. Dictionary files and manual colouring
  236. ----------------------------------------
  237. Lexikon (0001)
  238. Amiga characters
  239. 0x00ff0000 0xffffffff 2 0
  240. 0
  241. VOID
  242. LONG...
  243.  
  244. Line 1: This line identifies the file as lexicon and carries the 
  245. version number of the lexicon file.
  246.  
  247. Line 2: Comments
  248.  
  249. Line 3: RGB colour foreground and RGB colour background (V39 and higher)
  250.      foreground pen number and background pen number (V37 and V38)
  251. pen number
  252.  
  253. Line 4: Initial letters on/off
  254.  
  255. Line 5 - ...: Contents
  256.  
  257. From operating system V39 and higher RGB colours can be used for the 
  258. lexicon. The first two numbers indicate the  RGB colour for font and 
  259. background colour (24 bit). You can use hex numbers with "0x" as well.
  260.  
  261. If you use Kickstart V37/V38 pen numbers and colour are fixed. You 
  262. should run StormC on a screen with at least 8 colours to get best 
  263. results.
  264.  
  265. Attention:
  266. ----------
  267. As yet there is no error message if you use a non-existing or 
  268. non-proportional font. We recommand to use only fonts with characters 
  269. of the same width. Courier is not such a font. Some characters are 
  270. broader than the width indicated in the font. So there may be some  
  271. strange effects at the margin of the text.
  272.  
  273. Find&Replace are now completely accessible by keys.
  274.  
  275. We integrated a simple print function which prints the whole text.
  276.  
  277.  
  278. Keyboard settings:
  279. -----------------
  280.  
  281. Shift-Cursor Up/Down
  282. Moves the cursor to the first/last line.
  283.  
  284. Shift-Cursor Left/Right
  285. Moves the cursor to the first/last column of the current line.
  286.  
  287. Alt-Cursor Up/Down
  288. Jumps to the beginning/end of the text.
  289.  
  290. Alt-Cursor Left/Right
  291. Moves the cursor to the next word before or to the last behind the 
  292. cursor.
  293.  
  294. Shift-Delete or Shift-Backspace
  295. Deletes the line under the cursor. The line is stored in the clipboard.
  296.  
  297. Alt-Delete
  298. Deletes the line from the cursor position up to the end of the line.
  299.  
  300. Alt-Backspace
  301. Deletes the text between the first column up to the cursor.
  302.  
  303. Help
  304. Sends the word under the cursor to the Hothelp library V3.0 (14. Feb 94).
  305.  
  306.  
  307. MagicMenu and SUN-Mouse-Utilities
  308. ---------------------------------
  309.  
  310. If you use MagicMenu the mouse pointer freezes up to 10 seconds if you 
  311. are pressing the right mouse button over an icon of the icon bar. This 
  312. is because MagicMenu is not very OS compliant.
  313.  
  314. The same problem can appear with other SUN mouse utilities too.
  315.  
  316.  
  317.  
  318. If you have any questions please feel free to contact us:
  319.  
  320.    HAAGE & PARTNER Computer GmbH
  321.    Mainzer Strasse 10 A
  322.    61191 Rosbach
  323.    Germany
  324.  
  325.    Tel: ++49 06007 93 00 50
  326.    Fax: ++49 06007 75 43
  327.  
  328.    Internet: 100654.3133@compuserve.com
  329.    Compuserve: 100654,3133
  330.  
  331.    Please visit our home page to get the newest information on StormC:
  332.  
  333.    http://home.pages.de/~haage
  334.  
  335.  
  336. Now we want to thank our beta testers.
  337.  
  338. Thank you very much:
  339.  
  340.     Dietmar Augustin
  341.     Olaf Barthel
  342.     Holger Burkarth
  343.     Thomas Bayen
  344.     Bernhard Büchter
  345.     Michael Donner
  346.     Torsten Ebeling
  347.     David Göhler
  348.     Alexander Pratsch
  349.     Andreas Pfohl
  350.     Constantin Rack
  351.     Michael Rock
  352.     Jürgen Schildmann
  353.     Stephan Schüerholz
  354.    Thomas Wilhelmi
  355.  
  356. Special thanks to Jeroen T. Vermeulen.
  357.  
  358.  
  359. (c) 1996 HAAGE & PARTNER Computer GmbH
  360.  
  361.  
  362.